---
title: "read_me"
author: "Vinicius Santos"
date: "2025-09-27"
output: html_document
---

# Article title  
**Before the Alarm Sounds: How Parliaments Manage Silence, Salience, and Control in Foreign Affairs**

**Authors:** Vinicius Santos  
**Journal:** Revista Brasileira de Política Internacional (RBPI)  
**DOI (article):** [a ser inserido]

---

## 1. Description  
This replication package provides the data and scripts used to produce the analyses in the article. It includes cleaned legislative records from the Brazilian Senate (1985–2025), classification outputs, and scripts for reproducing descriptive statistics, figures, and case study references.

---

## 2. Data Sources  
- **Primary data:** Official records of the Senado Federal (Brazilian Federal Senate).  
- **Coverage:** January 1985 – December 2025.  
- **Unit of observation:** Individual legislative requests (*requerimentos*).  
- **Final dataset size:** 70,777 unique records after deduplication.  

---

## 3. Files in this package  
- `dados_filtrados.csv` – Cleaned dataset with unique observations (70,777 rows).  
- `analysis_scripts.R` – R scripts for data cleaning, classification, and replication of figures/tables.  
- `README.md` – Documentation file (this file).  

---

## 4. Variables in `dados_filtrados.csv`  
The dataset contains 70,777 observations and 23 variables. Below we describe the key variables:

- **id**: Unique identifier of the request (*requerimento*).  
- **identificacao**: Official request number (e.g., RQS 591/1991).  
- **tipoDocumento**: Document type (e.g., *Requerimento*).  
- **tipoConteudo**: Substantive content category of the request.  
- **ementa**: Short summary of the request.  
- **autoria**: Author(s) of the request.  
- **codigoParlamentarAutor**: Numeric code identifying the authoring senator.  
- **ano**: Year of presentation.  
- **dataApresentacao**: Date of presentation.  
- **dataDeliberacao**: Date of deliberation (if applicable).  
- **siglaTipoDeliberacao**: Outcome of deliberation (e.g., *APROVADA_NO_PLENARIO*).  
- **tramitando**: Whether the request was still under consideration.  
- **casaIdentificadora / enteIdentificador**: Institutional identifiers (Senate, Plenary, Committee).  
- **codigoMateria**: Associated legislative matter code.  
- **objetivo, normaGerada, urlDocumento, ultimaInformacaoAtualizada, dataUltimaAtualizacao, apelido**: Administrative/metadata fields (may contain missing values).  
- **governo**: Presidency at the time (e.g., Collor, FHC, Lula).  
- **oversight_dimension**: Deductive classification into oversight dimensions (e.g., Symbolic Performance, Strategic Activation, Procedural Friction).  

---

## 5. Replication Instructions  
1. Open `analysis_scripts.R`.  
2. Set working directory to the folder containing the dataset.  
3. Run.  

All results reported in the article can be reproduced using these files.  

---

## 6. Notes and Limitations  
- Raw data were obtained from the Senate’s official Sileg database.  
- Deduplication was performed using `distinct(id, .keep_all = TRUE)`.  
- Classification into *oversight_dimension* and *conceptual_stage* followed the typology described in Section 3 of the article.  
- The dataset does not include off-record negotiations or informal legislative practices.  

---

## 7. Citation  
Please cite both the article and this dataset when using these materials:  

- **Article:** [Full citation of your RBPI article once published]  
- **Dataset:** [Author]. (2025). *Replication Data for: Proactive Calibration: Legislative Oversight in Brazilian Foreign Policy*. Harvard Dataverse. DOI: [insert DOI].  

